====== Toolbox Plugin ======

---- plugin ----
description: Adds various tools to the editor toolbar
author     : Andreas Gohr 
email      : andi@splitbrain.org 
type       : Action
lastupdate : 2017-03-18
compatible : Frusterick Manners, Greebo, Hogfather
depends    : 
conflicts  : 
similar    : 
tags       : javascript, toolbar, sort, indent, wordcount, list, findandreplace, toolbox, replace, find

downloadurl: https://github.com/splitbrain/dokuwiki-plugin-toolbox/zipball/master
bugtracker : https://github.com/splitbrain/dokuwiki-plugin-toolbox/issues
sourcerepo : https://github.com/splitbrain/dokuwiki-plugin-toolbox/
donationurl: http://donate.dokuwiki.org/Toolbox

screenshot_img: http://i.imgur.com/1Rc5tZi.png
----

===== Download and Installation =====

Search and install the plugin using the [[plugin:extension|Extension Manager]]. Refer to [[:Plugins]] on how to install plugins manually.

==== Browser Extensions ====

If you want to use this plugin on a wiki that does not have it installed (eg. on dokuwiki.org or a wiki where you have no administrative control) you can also install it as a browser extension((It's a [[https://developer.mozilla.org/en-US/Add-ons/WebExtensions|WebExtension]] suitable for multiple browsers)).

The browser extension will automatically inject the appropriate JavaScript when you edit a DokuWiki page. It will look and feel exactly as if the plugin was installed for all users in that wiki.

  * [[https://addons.mozilla.org/en-US/firefox/addon/dokuwiki-toolbox/|Firefox Addon]]
  * [[https://chrome.google.com/webstore/detail/dokuwiki-toolbox/ipfidnedfockcnklpkmbcinjfpfgbbin|Chrome Extension]]

Theoretically it should be possible to install the same extension in Microsoft Edge as well, but it seems their store is not open for developers, yet.

==== Changes ====

{{rss>https://github.com/splitbrain/dokuwiki-plugin-toolbox/commits/master.atom date}}

===== Usage =====

The plugin adds a new picker to the toolbar which provides the following functions.

==== Sort Ascending ====

Selected text is sorted line by line in ascending order. Use this to sort tables or lists. No, this does not let you sort a table by the second column or any other sophisticated thing. It just sorts text lines alphabetically.

==== Sort Descending ====

Same as above but reversed

==== Add Indention ====

Selected lines are indented by two spaces. Nice to quickly change the level of a bunch of list items.

==== Remove Indention ====

Same as above but removes two spaces.

==== Word Count ====

This basically implements the features of [[tips:wordcounter]] into an on-demand counter. It counts characters and words of the total page, the currently edited section (if any) and the selected text (if any).

Might not always be 100% correct, but should be good enough.

{{https://i.imgur.com/adbrSq8.png?recache}}

==== Find and Replace ====

This opens a Find and Replace dialog. It allows you to search the text in the editor and do replacements.

{{http://i.imgur.com/woe7p0s.png?recache}}

===== More features =====

Might come some day. Earlier if you send patches. Here are a few ideas:

  * [[tips:bookmarklets|Table Cell prettification]]